SparkN0de-git - /page/blob.mu

Micron Document

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

| SparkN0de-git | SparkN0de |

Node / ReticulumProjects / MeshChatX.git / files / lang / README.ja.md

Displaying Raw • View rendered • Download

lang/README.ja.md e8e5128bc67cd3e8540bcd9f4e9be1b8d43db36a (e8e5128b) Text, 9.46 KB

Tc9d1d9# Reticulum MeshChatX

Liam Cottle 氏による Reticulum MeshChat を大幅に改修・機能拡張したフォークです。

本プロジェクトはオリジナルの Reticulum MeshChat とは独立しており、提携関係にありません。

Tff7b72- ソースコード: [Tff7b72git.quad4.io/RNS-Things/MeshChatX](Te6edf3https://git.quad4.io/RNS-Things/MeshChatX)

Tff7b72- リリース: [Tff7b72git.quad4.io/RNS-Things/MeshChatX/releases](Te6edf3https://git.quad4.io/RNS-Things/MeshChatX/releases)

Tff7b72- 変更履歴: [Ta5d6ff`CHANGELOG.md`](../CHANGELOG.md)

Tff7b72- TODO: [Ta5d6ff`TODO.md`](../TODO.md)

Tff7b72- [Tff7b72English README](Te6edf3../README.md) | [Tff7b72Deutsch](Te6edf3README.de.md) | [Tff7b72Italiano](Te6edf3README.it.md) | [Tff7b72Русский](Te6edf3README.ru.md) | [Tff7b72中文](Te6edf3README.zh.md)

Tc9d1d9## 重要事項

Tff7b72- LXMF の完全サポートがプロジェクトの中核目標です。

Tff7b72- データ保存とマイグレーションは段階的に直接 SQL へ移行中です（レガシーの Peewee ORM パスを置換）。

Tff7b72> [!WARNING]

Tff7b72> MeshChatX は旧バージョンの Reticulum MeshChat とのデータ互換性を保証しません。マイグレーションやテスト前にデータをバックアップしてください。

Tff7b72> [!WARNING]

Tff7b72> レガシーシステムはまだ完全にはサポートされていません。現在の最低要件: Python `>=3.11`、Node `>=24`。

Tc9d1d9## デモとスクリーンショット

Tc9d1d9### UI プレビュー

![Tff7b72電話](Te6edf3../screenshots/phone.png)

![Tff7b72ネットワークビジュアライザ](Te6edf3../screenshots/network-visualiser.png)

![Tff7b72アーカイブ](Te6edf3../screenshots/archives.png)

![Tff7b72アイデンティティ](Te6edf3../screenshots/identities.png)

Tc9d1d9## 必要条件

Tff7b72- Python Ta5d6ff`>=3.11`（Ta5d6ff`pyproject.toml` より）

Tff7b72- Node.js Ta5d6ff`>=24`（Ta5d6ff`package.json` より）

Tff7b72- pnpm Ta5d6ff`10.32.1`（Ta5d6ff`package.json` より）

Tff7b72- Poetry（`Taskfile.yml` および CI ワークフローで使用）

Tc9d1d9## Nix (flake.nix)

リポジトリに Ta5d6ff`flake.nix` が含まれています。

Tc9d1d9### 開発シェルに入る

Ta5d6ff```Ta5d6ffbash

nix develop

Ta5d6ff```

Tc9d1d9### デフォルトの Nix パッケージをビルド

Ta5d6ff```Ta5d6ffbash

nix build .#default

Ta5d6ff```

Tc9d1d9### `nix develop` 内の典型的なワークフロー

Ta5d6ff```Ta5d6ffbash

task install

task lint:all

task test:all

task build:all

Ta5d6ff```

Tc9d1d9## インストール方法

| -------------------------- | ------------------ | ------------------------------------- | ---------------------------------------- |

備考:

Tff7b72- リリースワークフローは Linux Ta5d6ff`x64` および Ta5d6ff`arm64` の AppImage + DEB を明示的にビルドします。

Tff7b72- RPM もビルドが試みられ、成功時にアップロードされます。

Tc9d1d9## クイックスタート: Docker

Ta5d6ff```Ta5d6ffbash

docker compose up -d

Ta5d6ff```

デフォルトの compose ファイル:

Tff7b72- ホスト Ta5d6ff`127.0.0.1:8000` -> コンテナポート Ta5d6ff`8000`

Tff7b72- Ta5d6ff`./meshchat-config` -> Ta5d6ff`/config`（永続化用）

権限エラーが発生した場合:

Ta5d6ff```Ta5d6ffbash

sudo chown -R T79c0ff1000:1000 ./meshchat-config

Ta5d6ff```

Tc9d1d9## リリースアーティファクトからのインストール

Tc9d1d9### 1) Linux AppImage (x64/arm64)

Tff7b721. リリースから Ta5d6ff`ReticulumMeshChatX-v<バージョン>-linux-<アーキテクチャ>.AppImage` をダウンロード。

Tff7b722. 実行権限を付与して起動:

Ta5d6ff```Ta5d6ffbash

chmod +x ./ReticulumMeshChatX-v*-linux-*.AppImage

./ReticulumMeshChatX-v*-linux-*.AppImage

Ta5d6ff```

Tc9d1d9### 2) Debian/Ubuntu `.deb` (x64/arm64)

Tff7b721. Ta5d6ff`ReticulumMeshChatX-v<バージョン>-linux-<アーキテクチャ>.deb` をダウンロード。

Tff7b722. インストール:

Ta5d6ff```Ta5d6ffbash

sudo apt install ./ReticulumMeshChatX-v*-linux-*.deb

Ta5d6ff```

Tc9d1d9### 3) RPM ベースのシステム

Tff7b721. リリースに Ta5d6ff`ReticulumMeshChatX-v<バージョン>-linux-<アーキテクチャ>.rpm` がある場合はダウンロード。

Tff7b722. インストール:

Ta5d6ff```Ta5d6ffbash

sudo rpm -Uvh ./ReticulumMeshChatX-v*-linux-*.rpm

Ta5d6ff```

Tc9d1d9### 4) Python wheel (`.whl`)

リリースの wheel にはビルド済みの Web アセットが含まれています。

Ta5d6ff```Ta5d6ffbash

pip install ./reticulum_meshchatx-*-py3-none-any.whl

meshchat --headless

Ta5d6ff```

Ta5d6ff`pipx` もサポート:

Ta5d6ff```Ta5d6ffbash

pipx install ./reticulum_meshchatx-*-py3-none-any.whl

Ta5d6ff```

Tc9d1d9## ソースからの実行（Web サーバーモード）

Ta5d6ff```Ta5d6ffbash

git clone https://git.quad4.io/RNS-Things/MeshChatX.git

Tffa657cd MeshChatX

corepack Tffa657enable

pnpm install

pip install poetry

poetry install

pnpm run build-frontend

poetry run meshchat --headless --host T79c0ff127.0.0.1

Ta5d6ff```

Tc9d1d9## サンドボックスで実行（Linux）

ネイティブの Ta5d6ff`meshchat` バイナリを、ファイルシステムをより隔離した状態で動かすには、Reticulum と Web UI 向けの通常のネットワークアクセスを保ちつつ **Firejail** または **Bubblewrap**（Ta5d6ff`bwrap`）を使えます。詳しい例（pip/pipx、Poetry、USB シリアルの注意）は次を参照してください。

Tff7b72- [Ta5d6ff`docs/meshchatx_linux_sandbox.md`](../docs/meshchatx_linux_sandbox.md)

同じページは、同梱または同期された Ta5d6ff`meshchatx-docs` から配信される場合、アプリ内の **ドキュメント**（MeshChatX ドキュメント）一覧にも表示されます。

Tc9d1d9## ソースからのデスクトップパッケージビルド

Tc9d1d9### Linux x64 AppImage + DEB

Ta5d6ff```Ta5d6ffbash

pnpm run dist:linux-x64

Ta5d6ff```

Tc9d1d9### Linux arm64 AppImage + DEB

Ta5d6ff```Ta5d6ffbash

pnpm run dist:linux-arm64

Ta5d6ff```

Tc9d1d9### RPM

Ta5d6ff```Ta5d6ffbash

pnpm run dist:rpm

Ta5d6ff```

Tc9d1d9## アーキテクチャサポート

Tff7b72- Docker: Ta5d6ff`amd64`, Ta5d6ff`arm64`

Tff7b72- Linux AppImage: Ta5d6ff`x64`, Ta5d6ff`arm64`

Tff7b72- Linux DEB: Ta5d6ff`x64`, Ta5d6ff`arm64`

Tff7b72- Windows: Ta5d6ff`x64`, Ta5d6ff`arm64`（ビルドスクリプトあり）

Tff7b72- macOS: ビルドスクリプトあり（`arm64`, Ta5d6ff`universal`）

Tff7b72- Android: リポジトリにプロジェクトと CI ワークフローあり

Tc9d1d9## Android

Tff7b72- [Ta5d6ff`docs/meshchatx_on_android_with_termux.md`](../docs/meshchatx_on_android_with_termux.md)

Tff7b72- [Ta5d6ff`android/README.md`](../android/README.md)

Tc9d1d9## 設定

| 引数 | 環境変数 | デフォルト | 説明 |

| --------------- | ---------------------- | ----------- | ---------------------------------- |

Tc9d1d9## ブランチ

| ブランチ | 目的 |

| -------- | ------------------------------------------------------------ |

| Ta5d6ff`master` | 安定版リリース。本番環境対応コードのみ。 |

| Ta5d6ff`dev` | 活発な開発中。不安定または不完全な変更を含む場合があります。 |

Tc9d1d9## 開発

Ta5d6ff```Ta5d6ffbash

task install

task lint:all

task test:all

task build:all

Ta5d6ff```

Tc9d1d9## セキュリティ

Tff7b72- [Ta5d6ff`SECURITY.md`](../SECURITY.md)

Tff7b72- 組み込みの整合性チェックと HTTPS/WSS デフォルト設定

Tff7b72- Ta5d6ff`.gitea/workflows/` の CI スキャンワークフロー

Tc9d1d9## 言語の追加

ロケールの検出は自動です。新しい言語を追加するには JSON ファイル1つだけで済みます:

Tff7b721. Ta5d6ff`en.json` からテンプレートを生成:

Ta5d6ff```Ta5d6ffbash

python scripts/generate_locale_template.py

Ta5d6ff```

Tff7b722. ファイル名を変更しロケールディレクトリに移動:

Ta5d6ff```Ta5d6ffbash

mv locales.json meshchatx/src/frontend/locales/xx.json

Ta5d6ff```

Tff7b723. ファイル先頭の Ta5d6ff`_languageName` にその言語の母語名を設定 (例: Ta5d6ff`"Espanol"`, Ta5d6ff`"Francais"`)。

Tff7b724. 残りの値をすべて翻訳。

Tff7b725. キーの整合性を確認: Ta5d6ff`pnpm test -- tests/frontend/i18n.test.js --run`

他のコード変更は不要です。

Tc9d1d9## クレジット

Tff7b72- [Tff7b72Liam Cottle](Te6edf3https://github.com/liamcottle) - オリジナル Reticulum MeshChat

Tff7b72- [Tff7b72RFnexus](Te6edf3https://github.com/RFnexus) - JavaScript Micron パーサー

Tff7b72- [Tff7b72markqvist](Te6edf3https://github.com/markqvist) - Reticulum, LXMF, LXST

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────